Motivation

As preparation for introduction of the extended addresses specification to DIP-0003, this pull request does the following:

• Deduplicate references to ipAddress and port (used to define the publicly advertised address of a masternode) to an appendix as they're present in both ProTx and SML structures and replacing it with a reference to an opaque field networkInfo.

• Deduplicate references to platform{P2P,HTTP}Port (used to define the port used in combination with ipAddress mentioned earlier to define publicly advertised addresses of a platform services) to the same appendix as they're present in ProTx structures and referenced in DIP-0028 and replacing it with a reference to an opaque field platformNetInfo.

  • Note, this change has not been made in the DIP-0004 document as the SML structure only stores platformHTTPPort

Additional Information

• Dependency for docs: document the extended addresses format in Appendix C of DIP-0003, add new {ProTx, SML} version to support it, add deprecation notices #164

• The "network byte order" description for platform{P2P,HTTP}Port has been dropped as this does not reflect the implementation as it stands. To illustrate, the port in networkInfo is stored as a CService in Dash Core and uses the following serialization (as of v22.1.2, source)

      SERIALIZE_METHODS(CService, obj)
      {
          READWRITEAS(CNetAddr, obj);
          READWRITE(Using<BigEndianFormatter<2>>(obj.port));
      }

  Compared to how platform{P2P,HTTP}Port is serialized in CProUpServTx (source)

          if (obj.nType == MnType::Evo) {
              READWRITE(
                  obj.platformNodeID,
                  obj.platformP2PPort,
                  obj.platformHTTPPort);
          }